/* XMLParserFactory.java                                           NanoXML/Java
 *
 * $Revision: 1.3 $
 * $Date: 2002/01/04 21:03:29 $
 * $Name: RELEASE_2_2_1 $
 *
 * This file is part of NanoXML 2 for Java.
 * Copyright (C) 2000-2002 Marc De Scheemaecker, All Rights Reserved.
 *
 * This software is provided 'as-is', without any express or implied warranty.
 * In no event will the authors be held liable for any damages arising from the
 * use of this software.
 *
 * Permission is granted to anyone to use this software for any purpose,
 * including commercial applications, and to alter it and redistribute it
 * freely, subject to the following restrictions:
 *
 *  1. The origin of this software must not be misrepresented; you must not
 *     claim that you wrote the original software. If you use this software in
 *     a product, an acknowledgment in the product documentation would be
 *     appreciated but is not required.
 *
 *  2. Altered source versions must be plainly marked as such, and must not be
 *     misrepresented as being the original software.
 *
 *  3. This notice may not be removed or altered from any source distribution.
 */

package net.n3.nanoxml;


import java.io.IOException;
import java.security.AccessControlException;


/**
 * Creates an XML parser.
 *
 * @author Marc De Scheemaecker
 * @version $Name: RELEASE_2_2_1 $, $Revision: 1.3 $
 */
public class XMLParserFactory {
    
    /**
     * The class name of the default XML parser.
     */
    public static final String DEFAULT_CLASS = "net.n3.nanoxml.StdXMLParser";
    
    
    /**
     * The Java properties key of the XML parser class name.
     */
    public static final String CLASS_KEY = "net.n3.nanoxml.XMLParser";
    
    
    /**
     * Creates a default parser.
     *
     * @see #DEFAULT_CLASS
     * @see #CLASS_KEY
     *
     * @return the non-null parser.
     *
     * @throws java.lang.ClassNotFoundException
     *		if the class of the parser or validator could not be found.
     * @throws java.lang.InstantiationException
     *		if the parser could not be created
     * @throws java.lang.IllegalAccessException
     *		if the parser could not be created
     */
    public static IXMLParser createDefaultXMLParser()
    throws ClassNotFoundException,
            InstantiationException,
            IllegalAccessException {
        // BEGIN PATCH W. Randelshofer catch AccessControlException
        String className = XMLParserFactory.DEFAULT_CLASS;
        try {
            className = System.getProperty(XMLParserFactory.CLASS_KEY,
                    XMLParserFactory.DEFAULT_CLASS);
        } catch (AccessControlException e) {
            // do nothing
        }
        // END PATCH W. Randelshofer catch AccessControlException
        return XMLParserFactory.createXMLParser(className,
                new StdXMLBuilder());
    }
    
    
    /**
     * Creates a default parser.
     *
     * @see #DEFAULT_CLASS
     * @see #CLASS_KEY
     *
     * @param builder the XML builder.
     *
     * @return the non-null parser.
     *
     * @throws java.lang.ClassNotFoundException
     *		if the class of the parser could not be found.
     * @throws java.lang.InstantiationException
     *		if the parser could not be created
     * @throws java.lang.IllegalAccessException
     *		if the parser could not be created
     */
    public static IXMLParser createDefaultXMLParser(IXMLBuilder builder)
    throws ClassNotFoundException,
            InstantiationException,
            IllegalAccessException {
        // BEGIN PATCH W. Randelshofer catch AccessControlException
        String className = XMLParserFactory.DEFAULT_CLASS;
        try {
         className = System.getProperty(XMLParserFactory.CLASS_KEY,
                XMLParserFactory.DEFAULT_CLASS);
         } catch (AccessControlException e) {
             // do nothing
         }
        // END PATCH W. Randelshofer catch AccessControlException
        return XMLParserFactory.createXMLParser(className, builder);
    }
    
    
    /**
     * Creates a parser.
     *
     * @param className the name of the class of the XML parser
     * @param builder the XML builder.
     *
     * @return the non-null parser.
     *
     * @throws java.lang.ClassNotFoundException
     *		if the class of the parser could not be found.
     * @throws java.lang.InstantiationException
     *		if the parser could not be created
     * @throws java.lang.IllegalAccessException
     *		if the parser could not be created
     */
    public static IXMLParser createXMLParser(String      className,
            IXMLBuilder builder)
            throws ClassNotFoundException,
            InstantiationException,
            IllegalAccessException {
        Class cls = Class.forName(className);
        IXMLParser parser = (IXMLParser) cls.newInstance();
        parser.setBuilder(builder);
        parser.setValidator(new NonValidator());
        return parser;
    }
    
}
